Skip to main content

Zapier 与 CRM 应用的集成结构

CRM（客户关系管理）应用是详细的数据库，用于将联系人链接到公司、公司链接到交易等。

要在 Platform UI 中添加 CRM 应用集成：

先决条件​

1. 为 CRM 中的常见记录类型添加触发器​

  • 查看其他 CRM 应用使用的 常见记录类型 作为触发器。
  • 为新记录和更新记录构建单独的触发器。对于 CRM 的 更新 触发器，最好让用户能够指定要监视更新的特定字段，而不是对所有更新都触发。
  • 如果您的应用允许用户添加自定义过滤器或视图，请包含过滤选项。最佳实践是显示一个可选的 动态下拉菜单，并按最近添加的顺序排序用户的过滤器。

Platform UI 与 CLI 比较

2. 在 API 配置下选择触发器类型​

REST Hook 触发器​

  • 如果您的应用支持通过 REST API 操作的 Webhook 订阅，请使用 REST hooks 作为触发器，以便在记录添加到 CRM 时立即将新记录发送到 Zapier。
  • Webhook 触发器在 Zap 编辑器 中标记为 即时。
  • 当用户在短时间内创建大量应用记录时，Webhook 会让您的集成更稳健，防止新记录数量超过轮询结果的页面大小。
  • 使用 REST hooks 时，Zapier 无需反复轮询您的 API 来检查新响应。

轮询触发器​

  • 使用轮询触发器时，对于 REST Hook 触发器的 执行列表 URL，轮询 URL 应返回最近创建或更新（如果触发器是“更新记录”类型）的记录。
  • 如果没有最近的新记录，请返回一个空数组。Zapier 会提示用户创建一个样本并在 Zap 编辑器中重新测试触发器，以完成 Zap 的映射。

3. 更新记录触发器的其他注意事项​

  • 用户期望更新触发器在记录添加新数据或添加/移除关联数据时运行。
  • 对于 REST hook 触发器，确保当关联数据重新应用于记录时，您的应用会将更新后的记录发送给 Zapier。
  • 对于轮询触发器，为了处理 去重，您需要自定义 API 调用代码，确保每个记录都有一个唯一的主键（通常是 id 字段）。这可能意味着 复制一个唯一的时间戳 到 id 字段，或 将 primary 设置为 true 对于某些输出字段。

在触发器响应中包含链接信息​

  • CRM 记录是链接数据生态系统的一部分。例如，如果您的触发器是“新联系人”，并且新添加的联系人链接到组织，用户期望看到完整的组织数据。
  • 在响应输出中包含链接数据的 ID，以便用户可以将它们映射到您应用的后续操作步骤中，同时包括人类可读的数据，如名称和联系信息。
  • 如果您的记录 API 端点未自动返回 ID 或记录名称以外的额外链接数据，请在触发器 API 调用中添加自定义代码来获取与记录相关的相关数据。

处理自定义字段​

  • 使用 分页 来检索用户可能期望的自定义字段。

处理标签​

  • 将记录上的标签返回为字符串数组，或以逗号分隔的列表形式，以便用户轻松地将它们映射到其他应用操作中。

4. 包含常见搜索操作​

  • 用户期望 CRM 集成中提供常见记录的搜索功能，并且这些搜索的字段应与相同记录触发器返回的字段保持一致。例如，用户可能有一个 新联系人 触发器，然后希望通过 查找组织 搜索来获取更多关于联系人关联组织的信息。如果 新联系人 触发器只提供关联组织的 ID，那么 查找组织 搜索只允许按组织名称搜索就没有意义。
  • 配置搜索以查找现有记录，并以触发器返回记录的相同格式返回记录，从而提供一致的体验，并允许数据在后续操作中使用。
  • 在适用的情况下，提供多个搜索键和值选项。
  • 对于唯一字段（如电子邮件），通过只提供单个搜索查询来防止去重问题，而不是多个选项。这可以防止用户搜索其他字段、尝试创建新记录，然后看到已存在该电子邮件记录的错误。
  • 如果找不到记录，不要返回错误。相反，返回一个 200 成功响应并带有一个空数组。这样，用户可以将搜索与 创建 操作配对，以让用户搜索记录并在不存在时创建它们。用户会看到暂停异常而不是错误。

了解更多关于配对 搜索和创建 的信息。

5. 包含常见创建操作​

  • 查看其他 CRM 应用拥有的 常见记录类型 的创建操作。
  • 使用标准的 创建 或 添加 命名模式，让用户知道此操作会在您的应用中创建新记录。
  • 添加相应的 更新 操作，并与可用 搜索 操作配对，以便用户更轻松地更新正确记录。
  • 在操作输入字段中考虑关联记录，如果您的应用 UI 允许用户创建联系人并将其链接到现有公司或阶段，则通过 Zapier 提供相同的操作，使用 动态下拉菜单 来获取链接记录选项并让用户选择它们。
  • 如果用户需要让 Zap 查找正确的相关记录并将找到的 ID 映射到输入字段，可选择为链接记录输入字段添加 搜索连接器。要添加此用户提示，您需要在 Platform CLI 中工作。
  • 不要让单个操作创建多个记录。当用户通过 Zapier 创建新联系人时，这应该只创建新联系人，而不应同时创建其他链接记录。相反，请包含一个单独的操作来创建其他链接记录，以及一个联系人更新操作来在其他记录创建后链接联系人。这可以减少错误和记录冗余的可能性。
  • 在操作输入字段中考虑 自定义字段，显示人类可读的标签而不是内部 ID。
  • 您集成的第一个版本不需要包含所有可能的操作，但可以在未来更新中添加用户期望或请求的兼容功能。

6. 支持应用内工作流​

  • 如果在您的应用中创建的新记录会自动添加到应用内工作流、序列、后续操作或活动，则确保通过 Zapier 的 API 创建的记录也会自动添加到工作流中。
  • 可选地在操作输入字段中添加一个布尔字段，让用户选择是否希望将此联系人添加到工作流中，或包含一个 动态下拉菜单 来选择他们想要的工作流。

7. 测试您的触发器和操作​

使用以下标准创建 Zap，以确保您的应用集成按预期工作：

  • 在您的应用中添加一个带有许多自定义字段的记录，并创建一个 Zap 来监视新记录，以确保每个字段在触发时都被包含并可以在后续步骤中映射。
  • 创建一个多步骤 Zap，至少包含一个触发器、搜索和操作步骤，其中每个步骤都使用您的应用集成，以检查链接步骤的易用性。
  • 如果您的集成操作中包含链接记录选项，请验证这些记录在通过 Zap 创建时是否正确链接。

需要帮助？告诉我们您的问题，我们会将您连接到正确的资源或支持团队。